'\"macro stdmacro
.\"
.\" Copyright (c) 2000-2004 Silicon Graphics, Inc.  All Rights Reserved.
.\"
.\" This program is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License as published by the
.\" Free Software Foundation; either version 2 of the License, or (at your
.\" option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
.\" or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" for more details.
.\"
.\"
.TH PMUSEZONE 3 "PCP" "Performance Co-Pilot"
.SH NAME
\f3pmUseZone\f1 \- re-establish a reporting timezone
.SH "C SYNOPSIS"
.ft 3
.ad l
.hy 0
#include <pcp/pmapi.h>
.sp
int pmUseZone(const int \fItz_handle\fP);
.sp
cc ... \-lpcp
.hy
.ad
.ft 1
.SH DESCRIPTION
The current reporting timezone effects the timezone used by
.BR pmCtime (3)
and
.BR pmLocaltime (3).
.PP
The argument
.I tz_handle
identifies a reporting timezone as previously established by
a call to
.BR pmNewZone (3)
or
.BR pmNewContextZone (3),
and this becomes
the current reporting timezone.
.SH DIAGNOSTICS
A return value less than zero indicates the value of
.I tz_handle
is not legal.
.SH SEE ALSO
.BR PMAPI (3),
.BR pmCtime (3),
.BR pmLocaltime (3),
.BR pmNewContextZone (3),
.BR pmNewZone (3)
and
.BR pmWhichZone (3).
